home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / print / fold33.zip / FOLD.DOC < prev    next >
Text File  |  1993-11-11  |  43KB  |  1,101 lines
  1.  
  2.                                FOLD-and-PRINT
  3.                                  version 3.3
  4.  
  5.                                 User's Manual
  6.  
  7.                           (C) Konrad Budych 1989-93
  8.  
  9.  
  10.         FOLD-and-PRINT is a utility that allows you to print an ASCII text in
  11. a multi-column format using either single sheets or a fanfold paper on
  12. (probably) any line printer.  This saves paper costs and makes it easier to
  13. read texts.  It is useful when you want to print long source code listings,
  14. software documentation, or any long and unformatted ASCII texts.
  15.  
  16.         FOLD-and-PRINT always prints in text mode to avoid slow graphics
  17. printing and may use all features that are specific to your printer as the
  18. program is completely configurable.  It is possible to print selected pages of
  19. the text: even-, or odd-numbered, starting from, or ending after a given page.
  20. You may prepare easily printouts that you may bind in a binder.  All features
  21. are described later in this manual.
  22.  
  23.         I have been using and writing this program for more than 3 years.  It
  24. was improved, changed, and rewritten many times.  As I find it really useful I
  25. think it may be useful to others too.  Just give it a try, play with some
  26. configurations, and very soon you will discover its value.
  27.  
  28.         Real life example: the Canonical List of Blonde Jokes dated 27 Sep
  29. 1993 takes 34 pages (17 sheets) if just copied to printer.  But it takes only
  30. 13 pages (10 sheets saved) if printed in two columns on any ESC/P compatible
  31. printer using 80 lines of 160 characters or 6 pages (14 sheets saved) if
  32. printed in three columns on ESC/P2 printer (Epson LQ-100) using 128 lines of
  33. 192 characters.  Of course the sheet size is always the same.  And magnifying
  34. glass is not necessary to read these printouts.
  35.  
  36.         Laser printer users: sorry.  This program cannot be configured to page
  37. oriented printers, you can use it only if your printer is or emulates some
  38. line printer.
  39.  
  40.  
  41.  
  42.  
  43. WHAT DOES FOLD-and-PRINT EXACTLY DO?
  44. ====================================
  45.  
  46.         When you print a text with 'COPY ATEXT.EXT PRN', 'PRINT ATEXT.EXT', or
  47. something similar, you usually get a sheet or two (or hundred) of paper or few
  48. meters (or miles) of fanfold paper that has text printed only near the left
  49. margin, has about 50 to 60 lines on page, and is printed with font which you
  50. can set on the printer's panel.
  51.  
  52.         When you browse through the user's manual of any printer, you should
  53. see, that the printer can print in many modes that are mostly unused by
  54. professional, big applications.  These applications usually offer much more
  55. features, but they print mostly in graphic modes, and if you have a slow
  56. printer you sooner or later stop using them for printing ASCII texts (if you
  57. have ever started).
  58.  
  59.         Most dot matrix printers can emulate ESC/P commands.  This commands
  60. allow to select different font pitches and line spacings.  It is no magic to
  61. print 80 lines of 160 characters on a page.  This is still very readable and
  62. there is about 3 times more text on such a page than when you use default 55
  63. lines of 80 characters.  Of course if your printer does not support ESC/P
  64. commands you may still use FOLD-and-PRINT.  Only you will probably have to
  65. experiment with different features of your printer.
  66.  
  67.         What FOLD-and-PRINT really does is this: it formats a given ASCII
  68. texts into multi-column format, and sends it to the printer, page by page,
  69. preceded and followed by some control codes.  The page length, width, margins,
  70. line spacing, etc.  are all up to you.  Just give FOLD-and-PRINT control codes
  71. to be sent to printer, tell it how many lines fit on a page, how many
  72. characters fit in a line, and that's all!  You may make your printouts even in
  73. 9 columns from now!
  74.  
  75.         To find more details on how to configure FOLD-and-PRINT see below.  If
  76. your printer supports ESC/P (most printers do), you may test using the example
  77. configurations included in the package.
  78.  
  79.  
  80.  
  81.  
  82. HOW TO INSTALL FOLD-and-PRINT?
  83. ==============================
  84.  
  85.         Follow these simple rules when installing FOLD-and-PRINT:
  86.  
  87. * All *.P files should be in the same directory in which you keep FOLD.EXE.
  88. * It is nice to be able to run FOLD-and-PRINT from any directory and drive.
  89. * Do not install FOLD-and-PRINT if you do not have DOS version 3.0 or newer.
  90.  
  91.         You may just copy FOLD.EXE and *.P files to some directory listed in
  92. your PATH, or create separate directory (like C:\FOLD) and create a BATch file
  93. in one of directories listed in PATH.  The batch may look like this:
  94.  
  95.                 @echo off
  96.                 set fold=-tW -qt -i
  97.                 c:\fold\fold.exe %1 %2 %3 %4 %5 %6 %7 %8 %9
  98.                 set fold=
  99.                 echo on
  100.  
  101.         The FOLD environmental variable is used to turn on default options.
  102. You may SET it in the batch, in AUTOEXEC.BAT, or do not set it at all if you
  103. do not need it.  See below for options description.
  104.  
  105.         After you have learned how to use and configure FOLD-and-PRINT, do not
  106. keep *.DOC files on your hard disk --- the manuals are longer than the program
  107. itself!  Just hide the original archive file on some forgotten diskette in
  108. case you ever want to read this text again or your hard disk crashes.
  109. FOLD.EXE and a couple of .P files is enough to use FOLD-and-PRINT.
  110.  
  111.  
  112.  
  113.  
  114. USING FOLD-and-PRINT
  115. ====================
  116.  
  117.         First you will be presented some examples introducing step by step the
  118. major features of FOLD-and-PRINT.  The complete syntax and full options
  119. description is presented at the end of this section.
  120.  
  121.         All these examples assume that you have FOLD-and-PRINT configured and
  122. ready to use.  If your printer supports ESC/P, FOLD-and-PRINT is ready to use
  123. with default parameters: the condensed Elite font of 80 lines of 160
  124. characters per page is used by default.  Use another mode by copying any .P
  125. file to DEFAULT.P or (which is better) using 'p' option, for example:
  126.  
  127.                 FOLD -pTINY FOLD.DOC
  128.  
  129.   If your printer does not support ESC/P commands you will have to configure
  130. FOLD-and-PRINT first.  See 'COFIGURING FOLD-and-PRINT' section for details.
  131.  
  132.  
  133.  
  134.  
  135. QUICK START
  136. -----------
  137.  
  138.         To print this file in two columns run:
  139.  
  140.                 FOLD -2 FOLD.DOC
  141.  
  142. You will be prompted for confirmation before the printing starts, and before
  143. each page.  Pressing [ESC] always exits to DOS.
  144.  
  145.         If you want to know how many pages of the text will be produced by
  146. FOLD-and-PRINT run:
  147.  
  148.                 FOLD FOLD.DOC
  149.  
  150. FOLD-and-PRINT will analyze the text first, and display how many pages, and
  151. how many 'cuts' (see below) you will get if you use 1, 2, 3, up to 9 columns
  152. of text.  Then you will be prompted to press [1], [2], ...  [9] to start or
  153. [ESC] to quit.  You may always force the analysis of a text using 'a' option:
  154.  
  155.                 FOLD -2 -a FOLD.DOC
  156.  
  157. In this case when prompted you just have to press [ENTER] to use 2 columns.
  158. Of course, thanks to 'a' option, you may use 3 or 8 columns even if you
  159. specified '2' in command line.
  160.  
  161.  
  162.  
  163.  
  164. WHEN COLUMN IS TOO NARROW
  165. -------------------------
  166.  
  167.         When column is too narrow a 'cut' occurs.  Normally the text which
  168. would not fit in a column will be printed in the same column in the next line.
  169. The number of cuts in texts can be determined in text analysis.
  170.  
  171.         When the text is cut, a word may be broken in any place.  When many
  172. words in text are broken, the text becomes illegible.  To prevent this, you
  173. may use 'tw' option.  This makes FOLD-and-PRINT not break words in the middle,
  174. but move an entire word to the next line in the same column.  For example:
  175.  
  176.                 FOLD -4 FOLD.DOC
  177.  
  178. would produce a very hard to read printout, but
  179.  
  180.                 FOLD -4 -tw FOLD.DOC
  181.  
  182. would produce a not so hard to read printout.  Sometimes when a word is longer
  183. than the width of a column it is not possible to leave it intact.  In such
  184. cases FOLD-and-PRINT will behave as if the 'tw' option was off.
  185.  
  186.         You may not want to print the line endings that do not fit in a
  187. column.  They may